Inside Macintosh: OpenDoc Class Reference /

Part 1 - Classes and Methods / ODEmbeddedFramesIterator

CheckValid

The CheckValid method should check whether this embedded-frames iterator object is valid and generates an exception if it is not valid.

void CheckValid ();

DISCUSSION

Every subclass of ODEmbeddedFramesIterator must test the embedded-frames iterator's validity at the beginning of the implementation of each of its noninherited methods (except for the subclass-specific initialization method) by calling either this method or the IsValid method. Unlike the IsValid method, this method has no effect if this embedded-frames iterator is valid; otherwise it should generate an exception.

If you want to ensure that you make calls only to a valid embedded-frames iterator, without generating an exception, then call the IsValid method instead.

OVERRIDING

When you subclass ODEmbeddedFramesIterator, you must override this method. Your override method must not call its inherited method; that is, your override method must implement this method's functionality completely.

EXCEPTIONS

kODErrInvalidIterator

This embedded-frames iterator is invalid and should not be used because the part that created it no longer exists.

SEE ALSO

The ODEmbeddedFramesIterator::IsValid method (page 209).

Main | Page One | What's New | Apple Computer, Inc. | Find It | Contact Us | Help